home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / bbs / zchss18c.zip / NETCHESS.DOC < prev    next >
Text File  |  1996-07-09  |  8KB  |  196 lines
  1.  
  2.  
  3.     NETCHESS.DOC
  4.     Ver 1.8 April 1996
  5.  
  6.     Paul Fargen
  7.     6200 Richiewayne Drive
  8.     Louisville, KY
  9.  
  10.     Networking ZCHESS allows games to be played by users on different
  11.     BBSes while maintaining the games in the database of the regular
  12.     door.  This will aid in eliminating the typos and other
  13.     misunderstandings that are often a part of chess over a message
  14.     base.
  15.  
  16.     Beginning with version 1.8, the files that must be passed between
  17.     BBSes for networked games can be converted to FIDO .MSG format.  See
  18.     the section of this document
  19.  
  20.  
  21.  
  22.     QUICK START
  23.     You will configure the required parameters for networking while you
  24.     setup subs.  Normally, the subs to be networked will be labeled
  25.     OPENxx or something similar.  If you choose to change networking for
  26.     an existing sub, you can run SETUP again, and make whatever changes
  27.     that are required.
  28.  
  29.     CONFIGURATION
  30.     Use the same SETUP.EXE to setup networked chess.  Note that the
  31.     setup program must be for version 1.8 of Zchess or greater.
  32.     This is a sample NET.CFG file that will be placed in each NETxxx
  33.     subdirectory:
  34.  
  35. Serial number for the ODD  BBS     = BBS1
  36. Serial number for the EVEN BBS     = BBS2
  37. Message subject for this section = Chess Games Open3
  38. Path to file IN box         = INBOX\
  39. Path to file OUT box         = OUTBOX\
  40. BBS software             = 1(1=SBBS, 0=Other)
  41. Convert files to messages?     = 1(1=YES, 0=NO)
  42. Path to BBS messages         = C:\SBBS
  43. Message SUB for messages     = ZCHESS
  44. Abridge output?          = 0(1=Yes,0=No)
  45.  
  46.     Serial number for the ODD  BBS:
  47.     Will be the four character registration number for the BBS which can
  48.     start the odd numbered games between the two BBSes.  The Serial
  49.     number characters are the fourth, fifth, sixth and seventh
  50.     characters of the Registration number that is in the ZCHESS.KEY file
  51.     you receive after registering.  While you are evaluating ZCHESS, you
  52.     will be using the BBS ID that is entered on the fourth line of
  53.     ZCHESS.CFG.  Note that ZCHESS requires that the first charater of
  54.     unregistered ZCHESSes to be a dash.  This maintains the uniqueness
  55.     of Registration numbers thos registering.  The entry for the ODD BBS
  56.     will be either your Serial number or that of the BBS you are sharing
  57.     files with.
  58.  
  59.     Serial number for the EVEN BBS
  60.     Same as above, except will be the registration number of the BBS
  61.     that can start the even numbered games.
  62.  
  63.     Message subject for this section
  64.     This will be used as the Subject when files are transferred between
  65.     BBSes.  When files are being retrieved by the receiving BBS from
  66.     messages, the subject of the messages in the BBS message base must
  67.     match this exactly.  This entry is case sensitive, although Zchess
  68.     will do everything in its power to maintain the format of all first
  69.     letters of words to be capitalized, with the others to be lower
  70.     case.  Note that when searching for messages that will contain the
  71.     chess moves for a sub, the To and Subject entries are compared
  72.     between this NET.CFG file and the messages.  You should limit
  73.     posting privileges on the sub to discourage sabbotage.
  74.     NOTE:  For Synchronet BBS message transfer, please create the
  75.     first message for the sub from the BBS.  Netchess is not able
  76.     to create a sub from scratch.
  77.  
  78.     Path to INBOX
  79.     Can be set to a directory for download by other BBSes calling in.
  80.     If you are using Messages, will be used for temporary storage.
  81.  
  82.     Path to OUTBOX
  83.     Can be set to an uplode directory for other BBSes calling in.
  84.     If you are using Messages, will be used for temporary storage.
  85.  
  86.     BBS Software
  87.     Can be 1 or 0.  '1' specifies that you are running SYNCHRONET BBS,
  88.     and you therefor have the opportunity to use the SBBS message base
  89.     to send games.
  90.  
  91.     Convert Files to messages?
  92.     1 = Yes, if using SBBS only.
  93.  
  94.     Message sub for messages
  95.     Specify an eight char sub name for a message base you wish to
  96.     use.
  97.  
  98.     Abridge Output?
  99.     There are two forms available for sending game information from a
  100.     BBS; verbose and abridged.    A typical verbose-formatted game might
  101.     look like:
  102.  
  103.         Game number     = 1
  104.         White        = Paul Fargen@FARG 1400
  105.         Black        = Jim Knight@21ST 1400
  106.         Status        = 1 (In progress)
  107.         Started        = 823242675 (02-02-96)
  108.         1.    D2-D4  D7-D5
  109.         2.    C2-C4  E7-E6
  110.         Message to White
  111.         How's the weather out there?
  112.         ---
  113.  
  114.     Each of the first five lines must be present to uniquely identify a
  115.     game.  The game numbers will be the same on both BBSes, although the
  116.     sub may differ.  The four characters after white's and black's name
  117.     represent the BBS ID for that BBS.    As stated in ZCHESS.DOC, the BBS
  118.     ID is a part of the serial number you get when registering Zchess,
  119.     which guarantees a unique ID for each BBS.    For unregistered
  120.     versions, the BBS ID is generated by the sysop using SETUP.EXE.
  121.     Zchess will force the first character to be a dash, which will
  122.     preserve the uniqueness of the registered copies, but still allow
  123.     playing.
  124.  
  125.     To save a few seconds of download time, you may set the Abridged
  126.     flag to 1 (Yes).  This will result in NETCHESS.EXE formatting the
  127.     output file as
  128.  
  129.      W=Paul Fargen@FARG 1400
  130.      B=Jim Knight@21ST 1400
  131.      T=1
  132.      S=823242675
  133.      2.  C2-C4    E7-E6
  134.      3.  B1-C3    G8-F6
  135.      4.  G1-F3    ...
  136.      w=
  137.      How's the weather out there?
  138.  
  139.     All of the information is the verbose format is contained in the
  140.     abridged, but with a reduction in byte-size.
  141.  
  142.  
  143.     FILE NAME CONVENTION FOR MESSAGES:
  144.     If not converting messages, files with the following filenames
  145.     shall be created in the OUTBOX subdirectory:
  146.  
  147.     IDIDnnn.Zx
  148.  
  149.     where IDID will be the originator's Zchess ID (four characters,
  150.     assigned by your ZCHESS.KEY file,
  151.  
  152.     nnn is the day of the year (001-366),
  153.  
  154.     x is a sequential number.  Files are limited to 50 lines max.
  155.  
  156.     Path to BBS messages
  157.     Specify the DATA\SUBS directory exactly, if using SBBS.  Leave
  158.     as the default if not sending games in the messages.
  159.  
  160.  
  161.     COMMANDLINE SWITCHES FOR NETCHESS
  162.     There are two optional switches for netchess:
  163.  
  164.     IN - Specifies that only incomming messages or files should be processed.
  165.  
  166.     OUT - Specifies that only outgoing messages or files should be processed.
  167.  
  168.     INNER WORKINGS OF NETCHESS
  169.     Netchess loops through all sections, looking for those that have
  170.     networking defined by a NET.CFG.  If games are to be sent to the other
  171.     BBS, then an ASCII file is created in your OUTBOX path.  If you are to
  172.     rely file transfers in the interBBS communications, you should define
  173.     different INBOX and OUTBOX paths for each section.    For transfers via
  174.     an SBBS message base, the INBOX and OUTBOX paths can be identical.
  175.     Netchess does a shell to the SMBUTIL.EXE program that is provided by
  176.     Digital Dynamics.  Hence, if you are running NETCHESS as an event from
  177.     SBBS without swapping to disk, you must be sure that the shell from
  178.     NETCHESS to SMBUTIL is able to allocate sufficient memory.
  179.  
  180.     You can look at the .BAT files that are created by NETCHESS to do the
  181.     importation.  The method employed relies heavily on DOS redirection.
  182.     Command files are created that are redirected into SMBUTIL which allows
  183.     use of that normally interractive program as an unattended utility.
  184.  
  185.     USING FIDO .MSG FILES
  186.     Beginning with version 1.8, you can have NETCHESS convert your ASCII
  187.     game files to FIDO *.MSG files.  In SETUP.EXE, select 2 = FIDO for
  188.     the type of conversion when setting up a new section.  After you
  189.     ESC from the Setup New Section menu, the FIDO config menu will popup.
  190.     Enter your FIDO node number, and use the defaults for the From and To
  191.     addressing.
  192.  
  193.  
  194.  
  195.  
  196.